常用函数-get_post_meta()
说明
该函数返回指定文章中含有指定关键字自定义字段的值。参见 update_post_meta(), delete_post_meta() 和 add_post_meta() 。
用法
<?php $meta_values = get_post_meta($post_id, $key, $single); ?>
示例
缺省用法
<?php $key_1_values = get_post_meta(76, 'key_1'); ?>
其他示例
仅检索给定关键字的第一个值:
<?php $key_1_value = get_post_meta(76, 'key_1', true); ?>
更详细的示例参见 post_meta 函数示例页面。
参数
$post_id
(整数)(必需)希望从中得到数据的文章的编号。用$post->ID获取文章编号。
默认值:None
$key
(字符)(必需)字符,字符中含有希望的meta值的名称。
默认值:None
$single
(布尔值)(可选)如果默认值设为true,函数返回单个字符形式的结果。如果为false或为设置,则函数返回自定义字段的数组。
默认值:false
返回的值
- 若$single设为false或空,函数返回一个包含指定关键字的所有值的数组
- 若$single设为true,函数返回指定关键字的第一个值(不是数组)
无论$single值是什么,如果没有指定关键字,函数将返回空的字符。
相关资源
add_post_meta(), delete_post_meta(), update_post_meta(), get_post_custom(), get_post_custom_values(), get_post_custom_keys()
分类:中文手册